home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / stufit.arc / STUFIT.DOC < prev   
Text File  |  1985-11-18  |  14KB  |  261 lines
  1.                                STUFIT.COM
  2.  
  3.                             Disk file stuffer
  4.                             -----------------
  5.  
  6. V0.6 release 6.14.85
  7. Released to to public domain for personal use only.
  8. (c) 1985 Zider Brothers, San Francisco 
  9.  
  10. WARNING: You may lose a file with this program if you:
  11.             . interrupt it during operation
  12.             . run it on a non-IBM compatible machine
  13.          This loss is temporary.  See "Caution" section below.
  14.  
  15.  
  16. Program description
  17. -------------------
  18.  
  19. STUFIT is a program that "stuffs" files into the inner part of the disk.
  20.  
  21. That is, it will move a file from the outer part of a disk and into the
  22. free area nearest the spindle.  As a result, this inner area can be used for
  23. lesser-used programs, freeing up the outside tracks for working space.
  24. File access times can be improved considerably, especially for disks
  25. that are more than half full.
  26.  
  27. The program works for hard disks and diskettes.
  28.  
  29. Program syntax help is available on-line, by specifying the program with
  30. no arguments.  Paths are accepted, but a drive designation other
  31. than the default drive will generate an error.
  32.  
  33.  
  34. Disk space management
  35. ---------------------
  36.  
  37. The below display shows the space usage of a typical, just-loaded diskette.
  38. All the lower-numbered tracks (those closest to the directory) are fully
  39. loaded.  The higher-numbered tracks (those closest to the disk spindle,
  40. toward the inner part of the disk) are all empty:
  41.  
  42.      ----------------
  43.       Space Usage for the Complete Diskette
  44.  
  45.          63%  452 sectors given to available free space
  46.                 1 sector  given to the boot record
  47.           1%    4 sectors given to the file allocation table
  48.           1%    7 sectors given to the file directory
  49.          36%  256 sectors given to normal files
  50.                No sectors given to hidden, system or read-only files
  51.                No sectors given to unavailable space (free with CHKDSK)
  52.                No sectors given to conflicting file space allocation
  53.                No sectors given to Bad-Track (unusable)
  54.  
  55.                          Map of Diskette Space
  56.              Track       1         2         3        3
  57.                0123456789012345678901234567890123456789
  58.              1 B■■■■■■■■■■■■■■░░░░░░░░░░░░░░░░░░░░░░░░░  ░ Unused sector (free space)
  59.      Side  S 3 F■■■■■■■■■■■■■■░░░░░░░░░░░░░░░░░░░░░░░░░  B Boot record
  60.        0   e 5 F■■■■■■■■■■■■■■░░░░░░░░░░░░░░░░░░░░░░░░░  F File allocation table
  61.            c 7 D■■■■■■■■■■■■■■░░░░░░░░░░░░░░░░░░░░░░░░░  D Directory
  62.      ╞════ t 9 D■■■■■■■■■■■■■■░░░░░░░░░░░░░░░░░░░░░░░░░  ■ In use by a normal file
  63.            o 2 D■■■■■■■■■■■■■■░░░░░░░░░░░░░░░░░░░░░░░░░  h Hidden, system, read-only
  64.      Side  r 4 ■■■■■■■■■■■■■■■░░░░░░░░░░░░░░░░░░░░░░░░░  █ Temporarily unavailable
  65.        1     6 ■■■■■■■■■■■■■■■░░░░░░░░░░░░░░░░░░░░░░░░░  X Conflicting allocation
  66.              8 ■■■■■■■■■■■■■■░░░░░░░░░░░░░░░░░░░░░░░░░░  b Bad-Track (unusable)
  67.       F1-help F2-save F3-new file F4-import data F9-expand  F10-contract Esc-exit
  68.       -------------------------------
  69.  
  70. The complete diskette can all be stuffed by logging over to A: and executing
  71. the program with *.*:
  72.  
  73.      A>stufit *.*
  74.  
  75. The reorganized disk then looks as follows:
  76.  
  77.      ----------------
  78.       Space Usage for the Complete Diskette
  79.  
  80.          63%  452 sectors given to available free space
  81.                 1 sector  given to the boot record
  82.           1%    4 sectors given to the file allocation table
  83.           1%    7 sectors given to the file directory
  84.          36%  256 sectors given to normal files
  85.                No sectors given to hidden, system or read-only files
  86.                No sectors given to unavailable space (free with CHKDSK)
  87.                No sectors given to conflicting file space allocation
  88.                No sectors given to Bad-Track (unusable)
  89.  
  90.                          Map of Diskette Space
  91.              Track       1         2         3        3
  92.                0123456789012345678901234567890123456789
  93.              1 B░░░░░░░░░░░░░░░░░░░░░░░░░■■■■■■■■■■■■■■  ░ Unused sector (free space)
  94.      Side  S 3 F░░░░░░░░░░░░░░░░░░░░░░░░░■■■■■■■■■■■■■■  B Boot record
  95.        0   e 5 F░░░░░░░░░░░░░░░░░░░░░░░░░■■■■■■■■■■■■■■  F File allocation table
  96.            c 7 D░░░░░░░░░░░░░░░░░░░░░░░░░■■■■■■■■■■■■■■  D Directory
  97.      ╞════ t 9 D░░░░░░░░░░░░░░░░░░░░░░░░░■■■■■■■■■■■■■■  ■ In use by a normal file
  98.            o 2 D░░░░░░░░░░░░░░░░░░░░░░░░░■■■■■■■■■■■■■■  h Hidden, system, read-only
  99.      Side  r 4 ░░░░░░░░░░░░░░░░░░░░░░░░░░■■■■■■■■■■■■■■  █ Temporarily unavailable
  100.        1     6 ░░░░░░░░░░░░░░░░░░░░░░░░░■■■■■■■■■■■■■■■  X Conflicting allocation
  101.              8 ░░░░░░░░░░░░░░░░░░░░░░░░░■■■■■■■■■■■■■■■  b Bad-Track (unusable)
  102.       F1-help F2-save F3-new file F4-import data F9-expand  F10-contract Esc-exit
  103.       -----------------------------
  104.  
  105. All the quick-access space near the directory is now free for working
  106. storage.
  107.  
  108. A more representative hard disk situation is shown below.  Here, the disk
  109. has had a number of reference subdirectories stuffed into the inside,
  110. leaving a working space in the middle of the disk:
  111.  
  112.      -----------------------
  113.      ╔════════════════════════════════════════════════════════════════════════════
  114.      ║ Menu 2.3                                                                     ║
  115.      ║                    Map of Space Usage for the Entire Disk                    ║
  116.      ║                                                                              ║
  117.      ║                          34% of disk space is free                           ║
  118.      ║                                                                              ║
  119.      ║                        Proportional Map of Disk Space                        ║
  120.      ║            ■ ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■B■■■■■■■ B            ║
  121.      ║   represents ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■ represents   ║
  122.      ║        space ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■ bad          ║
  123.      ║       in use ░░■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■░░░ sectors      ║
  124.      ║              ░░░■■░░░░░░░■░░░░░░░░░░■░■■■■■■■■■■■■░░░░░░░░░░░░░              ║
  125.      ║              ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░              ║
  126.      ║              ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░              ║
  127.      ║              ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░■■░■■■■■■■░■■■■■■■■              ║
  128.      ║              ■■■■■■■■■■■■■■■■■■■■■■■░░░░■■■■■■■■■■■■■■■■■■■■■■■              ║
  129.      ║              ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■              ║
  130.      ║           Each position represents 1/500th of the total disk space           ║
  131.      ║                                                                              ║
  132.      ║              Press any key to continue...                                    ║
  133.      ║                                                                              ║
  134.      ╠══════════════════════════════════════════════════════════════════════════════╣
  135.      ║            Currently selected:  No file or disk sector selected              ║
  136.      ║                     Drive C:  Directory: root directory                      ║
  137.       F1-help F2-save F3-new file F4-import data F9-expand  F10-contract Esc-exit
  138.       -----------------------
  139.  
  140. At this point, the disk could no doubt benefit from stuffing some more of the
  141. less-frequently used files into the inside of the disk, freeing up the space
  142. nearest the outside.
  143.  
  144. In the final display below, the root directory files and the files on two
  145. of the larger subdirectories were stuffed.  The inner space of the disk
  146. is packed, but the outer/closer area is now  fragmented.  At some
  147. point a disk needs periodic maintenance in the form of a complete
  148. backup and restore, using STUFIT to put reference files away from the out-
  149. side of the disk.
  150.  
  151.      ------------------
  152.      ╔════════════════════════════════════════════════════════════════════════════
  153.      ║ Menu 2.3                                                                     ║
  154.      ║                    Map of Space Usage for the Entire Disk                    ║
  155.      ║                                                                              ║
  156.      ║                          36% of disk space is free                           ║
  157.      ║                                                                              ║
  158.      ║                        Proportional Map of Disk Space                        ║
  159.      ║            ■ ■■■■■■■■■■░░░░░■■░■░■░■░░░■■░■■■■■■■■■■■■░B░░░░■■■ B            ║
  160.      ║   represents ■■■■■■■■■■■■■■■░■░░░░░░░■░░░■░■■░░■■■■■■■■■░░■░■■■ represents   ║
  161.      ║        space ■■■■■■■■■■■■■■░■■░■░■░░░░░░░░░░░░░■■■■■░░░░░░■■░■■ bad          ║
  162.      ║       in use ░■░■░░░░░░░░░░░░░░■■■■■░░░░░░░░░░░░░░░░░░░░░░░░░░░ sectors      ║
  163.      ║              ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░              ║
  164.      ║              ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░■■■■■■■■■■■■■■              ║
  165.      ║              ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■              ║
  166.      ║              ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■              ║
  167.      ║              ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■              ║
  168.      ║              ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■              ║
  169.      ║           Each position represents 1/500th of the total disk space           ║
  170.      ║                                                                              ║
  171.      ║              Press any key to continue...                                    ║
  172.      ║                                                                              ║
  173.      ╠══════════════════════════════════════════════════════════════════════════════╣
  174.      ║            Currently selected:  No file or disk sector selected              ║
  175.      ║                     Drive C:  Directory: root directory                      ║
  176.       F1-help F2-save F3-new file F4-import data F9-expand  F10-contract Esc-exit
  177.       -------------------------------
  178.  
  179.  
  180. Operating Considerations
  181. ------------------------
  182.  
  183.                              CAUTION
  184.                              -------
  185.  
  186. This program copies, deletes and renames files in the course of operation.
  187. For this reason, if the program is interrupted you may lose a single file.
  188. This loss is temporary.  The following procedure will allow you to recover
  189. the lost file, if any.
  190.  
  191. Assuming you have interrupted the operation from the keyboard with ^<Break>
  192. or ^C, do the following:
  193.  
  194.      . Write down the last two file names appearing on the screen list
  195.             of file being processed.  Names on this list appear as the
  196.             file is to be processed, not after it has been stuffed. One
  197.             or the other file may have been lost, but not both.
  198.  
  199.      . Do a DIR on the default directory and look for a file named ZZ.TOP.
  200.             This is the temporary target file to which the original file
  201.             has been copied.  If it still exists, then it means the operation
  202.             was interrupted before this temporary file could be renamed to
  203.             the original file name.  It may also mean that the original file
  204.             still exists as well--see next step.
  205.  
  206.      . Do a DIR on the directory being reorganized (this may not be the
  207.             default directory if a path was specified, as with
  208.             C>stufit \cq\*.*).   If the original file still exists, then
  209.             it has not yet been deleted.  If the original file does not
  210.             exist, then it has already been deleted and the file ZZ.TOP
  211.             contains the original file contents, but in a new upper/inner
  212.             disk location as a result of being stuffed.  You may copy the
  213.             file ZZ.TOP to  original path\filename, and delete ZZ.TOP.
  214.             The file will now be "un-stuffed", but at least will be
  215.             restored to the original directory.
  216.  
  217.             Alternatively, you may MV (move) ZZ.TOP to the original
  218.             directory.   With this program, only the file directory
  219.             entries are changed--the file contents themselves remain on
  220.             the disk at the same (stuffed) location.  MV will create the
  221.             original file name entry on the named directory, move (copy) the
  222.             directory entry data from ZZ.TOP over to this directory, and
  223.             then delete the ZZ.TOP entry from the default directory.
  224.  
  225.      . DIR the default directory and look for a file named GOBBIGE.TXT.  If
  226.             this file still exists, delete it.  It is a place-holding file
  227.             only, with no content.
  228.  
  229. The foregoing procedure should allow you to interrupt the operation and
  230. recover any files that may have been in an intermediate state of transfer.
  231. Since the program operates on single files at a time, this will affect
  232. at most one file.
  233.  
  234. Inspection of the assembly source file MAIN.ASM should clarify further
  235. the actual steps executed by the program.
  236.  
  237. Setting BREAK to OFF will not solve the problem, but will limit the
  238. points at which the program operation can be interrupted.
  239.  
  240. If you are using this program on a non-IBM machine, you should proceed
  241. with some caution.  It has only been tested on an IBM PC XT and an IBM
  242. Portable Personal Computer.  It is best in any case to work with a
  243. subdirectory first to limit any damage that may occur as a result of
  244. using this program on your system.
  245.  
  246. Other
  247. -----
  248.  
  249. This document includes screen images from the Norton Utilities version 2.01
  250. and 3.0 captured with the Notepad function of SideKick.  The document
  251. will print correctly on an IBM PC Graphics printer, but may have some
  252. problems with other printers that do not support the high-bit graphics
  253. characters in the PC graphics character set.   This document also has lines
  254. longer than 80 characters, so TYPE'ing this file to the screen will
  255. result in wrapped long lines.  Use LIST.COM to display this doc
  256. without line wrap.
  257.  
  258. Doc: 11:47:11  6/14/1985
  259.  
  260.  
  261.